home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / net / bind-contrib.tar.gz / bind-contrib.tar / contrib / misc / cachebuild.shar / README < prev   
Encoding:
Text File  |  1996-10-25  |  2.9 KB  |  74 lines
  1.  
  2.             CACHE BUILD PROGRAM
  3.  
  4. DESCRIPTION:
  5.  
  6. This utility will build the latest root domain server cache for your
  7. BIND nameserver data base, by running nslookup to query one of the known
  8. root domain servers, and passing the output through an awk script to
  9. generate the file.  Simple, really.
  10.  
  11. Of course, your name server's current root.cache must have at least
  12. ONE working root domain server and its address, or you can't get to
  13. a root server to ask about other root servers.  (But then, you'd know
  14. it by now, your nameserver wouldn't be working!)  This will build a more
  15. up-to-date root.cache than the one that comes with the BIND distribution.
  16.  
  17. Run cachebuild every month or two to keep your nameserver up to date.
  18. You can run it from cron if you're brave.
  19.  
  20. Cachebuild should NOT be run on root name servers themselves --
  21. those sites are much too important to trust automated software!
  22. Cachebuild is intended to be used by normal Internet sites.
  23.  
  24. HOW IT WORKS:
  25.  
  26. The file "root.cache" is created in your currently directory when
  27. cachebuild is run.  Don't worry though, if there's an existing file
  28. by that name it will be moved to "root.cache.old" (and similarly,
  29. an existing file by that name is moved to "root.cache.older").
  30.  
  31. There's no guarantee that the output from this program is correct;
  32. after you generate a new root.cache file, examine it carefully and
  33. compare it with your old one.  Keep your old root.cache files around,
  34. just in case!
  35.  
  36. The only challenge is adjusting the awk script to work with the version
  37. of BIND that you happen to have installed.  The awk script included
  38. works with nslookup from BIND version 4.8.3 and from SunOS 4.1.3.
  39. You can modify it as needed.
  40.  
  41. INSTALLATION:
  42.  
  43. 1.  Edit the Makefile to make any modifications for your local site.
  44. 2.  Type "make" to build the shell script cachebuild.
  45. 3.  Type "make install" to install the program and awk script.
  46. 4.  Move into a safe place (cd /tmp) and try running cachebuild.
  47.     If you use the C-shell, you may need to type "rehash" first.
  48.     Cachebuild should create the file root.cache in your current
  49.     directory.  Examine it.
  50. 5.  If all is OK, you can safely run it in your name-server directory
  51.     or just copy the new root.cache over there.
  52.     If not, fix it, "make clean" and try again.
  53.  
  54. ERROR MESSAGES:
  55.  
  56. If it succeeds, cachebuild will return the usual exit status of 0.
  57. The only error message cachebuild generates is:
  58.  
  59.         Call to nslookup failed.
  60.  
  61. which means that nslookup exited with a non-zero status value
  62. (indicating an error of some sort).  Error messages from nslookup
  63. that are sent to stderr will come out on stderr from cachebuild, too.
  64.  
  65. COMPLAINTS DEPT:
  66.  
  67. Yea, I know, I should rewrite it in perl.  ENOTIME.
  68.  
  69. --
  70. Paul Balyoz, Senior Systems Programmer  pab@rainbow.cse.nau.edu
  71. Northern Arizona University             root@naucse.cse.nau.edu
  72. PO Box 15600, Flagstaff AZ 86011        {pab,root}@sunset.cse.nau.edu
  73. NICname: PB1                            ...arizona!naucse!root
  74.